<银联数据大模型报告生成项目>
数据解读服务界面用户使用手册
版本 <1.0>
修订历史记录
日期 | 版本 | 说明 | 作者 |
<日/月/年> | <x.x> | <详细信息> | <姓名> |
目录
1. 综述 4
1.1 背景 4
1.2 目标 4
1.3 范围 4
2. 使用说明 4
2.1 菜单说明 4
2.2 数据解读助手 5
2.2.1 界面功能介绍 5
2.2.2 数据解读整体操作流程(不使用增强功能) 6
2.2.3 数据解读整体操作流程(使用增强功能) 6
2.3 解读指标验证 6
2.3.1 界面功能介绍 6
2.3.2 操作流程 6
2.4 Prompt测试 6
2.4.1 界面功能介绍 6
2.4.2 操作流程 6
2.5 RAG文件管理(及子菜单) 6
2.5.1 界面功能介绍 6
2.5.2 操作流程 6
数据解读服务界面用户使用手册
本文档用于指导最终用户正确使用数据解读服务界面功能。本文档适合业务部门相关人员阅读,读者能根据手册执行工作任务。
本文档用于指导业务部门操作人员进行日常的线上工作,旨在帮助相关业务操作人员提高报告生成的工作效率,通过使用界面将数据输入到工具中,得到解读文字,掌握界面的正规使用方法。
本文档负责指导相关业务执行人员能正确执行数据解读服务的界面操作流程。
[按页面和功能顺序,以及作业流程顺序,描述系统操作]
数据解读服务界面主要面向数据解读API使用者,数据解读开发维护者进行开发测试使用。
该界面提供了四个核心功能页面:
[按照最新的界面菜单样式,简要截图+文字介绍每个页面的大致功能]
打开页面服务,数据解读助手为默认页面。左侧为输入面板,右侧为结果面板。
右侧结果面板,可以点开每个panel 查看系统返回的结果:
解读指标验证工功能是一个相对独立的功能,在前面的解读小助手里,它可以被一个选项按钮控制是否开启。但是用户也可能有从别的渠道或者方式获取到的解读数据以及解读结果,那么可以黏贴复制到这里,在这里,将得到更详细的细节。
在上面,上下文部分为可以包含对这个CSV数据的背景介绍,以及解读内容的补充。因为解读文本里的内容不一定完全来自 CSV 数据,可能参考了其他的信息,那么可以在这里添加进去,方便校验服务更好的校验。
在右侧版面,我们会可视化整个校验结果。
校验结果下面是统计数据,可以看到红黄绿个数分别是多少。
最后则是指标校验明细,可以看到原始值,校验值,以及该校验值如何通过代码计算得到。
解读服务内部流程较为复杂。很多情况你想知道没有任何其他干扰的情况,对某个prompt提示词模型的反馈是什么。这个时候就可以使用 Prompt 测试功能。
在数据解读助手页面,你可以得到解读服务的最终提示词:
拷贝该提示词到 Prompt 测试页面:
可以得到原生的大模型的内容,没有其他干扰。此外,用户也可以将该提示词黏贴到其他模型的测试页面,查看其他模型的回答效果。
内置的知识库服务是以文件系统作为存储的。我们可以通过 RAG 文件管理来上传,查看以及删除文档。
首先是上传页面:
接着是列表页:
以及删除页:
所以新增删除更新动作在知识库中都是即刻生效的。
[按页面和功能顺序,以及作业流程顺序,描述系统操作]
数据解读助手由两部分构成,左侧面板为交互区,右侧面板为结果区。
如果使用内置知识库,那么系统会默认提供引用文档地址:
如果用户提供了“数据上下文” 以及 emb 模型,那么可以开启该功能,则会一步展示,我们的解读参考了哪些“数据上下文”。
首先,我们先添加一个“数据上下文”,数据上下文是对csv 数据的一个补充信息。然后再开启 启用引用,
系统会让让你选emb模型以及相似度分数。大多情况使用默认值即可。
通过上下文,我们纠正了 csv 中的一些“错误数据”。
系统根据上下文,纠正了原始 csv 数据中的错误:
同时系统会告诉你,哪一句话(使用 \n分割)引用了这个“上下文”:
大模型计算会出错,所以我们提供了二次校验功能。可以校验解读结果中所有的数字。
按界面要求输入CSV数据,主题等,然后开启黄框中的“启用数据校验”
在右侧结果面板中,点击 “数据验证”面板:
此时可以看到校验结果:
如果你需要看到更加细节的展示,可以在 “解读指标验证” 界面查看。
该功能主要决定是否会使用内置知识库。
我们先来看关闭的解读效果:
此时解读效果如下,大模型会自由发挥解读,做了比较细致的分析:
现在我们在相同的数据情况下,开启 RAG:
此时的结果如下:
相当简约了。我们可以在 prompt 中看到系统从知识库中找到的示例解读:
该示例的出处可以可以在引用 panel 中找到:
通常,我们建议的一个合适流程为:
得到如下结果:
然后将结果拷贝到解读指标验证页面,完成指标的校验:
如上。
该功能页面,左侧为操作区,右侧为展示区。将数据解读的解读结果和原始数据,以及上下文,分别填入操作区,点击右侧即可得到校验结果。
得到如下结果:
然后将结果拷贝到解读指标验证页面,完成指标的校验:
Prompt 测试方便用户拷贝解读页面生成的 Prompt ,然后在此页面做修改调试。
在数据解读助手页面,你可以得到解读服务的最终提示词:
拷贝该提示词到 Prompt 测试页面:
可以得到原生的大模型的内容,没有其他干扰。此外,用户也可以将该提示词黏贴到其他模型的测试页面,查看其他模型的回答效果。
该子页面包含三个子菜单,分别为上传文件,文件列表,和文件删除三个部分。
首先进入文件上传界面,你可以上传文本文件,word 文档,excel文档,pdf 文档 等四种格式的文档。
选择文件后点击上传:
此时进入 文件列表菜单:
可以看到文件已经在知识库中。接着进入文件删除页面:
可以点击删除 来删除对应的文件。